home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 24 / AACD 24.iso / AACD / Utilities / PageStreamFilter / README < prev    next >
Text File  |  2001-07-04  |  15KB  |  357 lines
  1.  
  2.                      Universal Filter V2.1
  3.  
  4.                   http://www.uni.coloraid.de
  5.  
  6.  
  7.  
  8.                          Introduction
  9.                          ------------
  10.  
  11. The  'Universal'  filter  allows  reading  many image formats with
  12. PageStream   V3.x/V4.x   wich   are  not  originaly  supported  by
  13. PageStream.  It also allows formats like IFF ILBM and others to be
  14. loaded much faster.
  15.  
  16. The  new  'Universal'  V2  filter is now based on the IRW library.
  17. The  IRW  library  allows  loading  many  different  file formats.
  18. Actualy,  currently  most  of the features of IRW can't be used by
  19. PageStream (like support for IPTC, ICC and more).
  20.  
  21.  
  22.                          Requirements
  23.                          ------------
  24.  
  25.  - AmigaOS 2.04 or newer.
  26.  - PageStream V3.1, V3.2, V3.3, V3.4, V4.0 or newer
  27.  - The IRW library (usualy comes with the Universal filter)
  28.  
  29.  
  30.                          Features
  31.                          --------
  32.  
  33. The  Universal  filter  basicly does support all the CMYK, RGB and
  34. grayscale   image  formats  available  in  the  IRW  library  into
  35. PageStream.  But it does not only add support for many new graphic
  36. formats  to PageStream.  Often the Universal filter is MUCH faster
  37. and can load far more types of images.
  38.  
  39. Supported IRW library formats are:
  40.  
  41.       BMP:  1,  4, 8, 16, 24 and 32 Bit, Windows V3 and OS/2 format,
  42.             RLE4, 8, 24 compression
  43. DataTypes:  OS 3.0 DataTypes (24 Bit OS 3.5 support is planned)
  44.       DCX:  only the first image is loaded (IRW does support more)
  45.  IFF ILBM:  including HAM, HAM8, EHB, CMYK
  46.  IFF DEEP:  Not yet available in V2 - use Universal filter V1.xx
  47.      JPEG:  8 Bit, 24 and 32 Bit CMYK JFIF, progressive JPEG, Hemera
  48.       PCX:  1,2,4,8 and 24 Bit images
  49.       GIF:  (not shipped with all versions of the IRW library)
  50.  PGM/PBM/PPM:  P1-P6 types with up to 48 Bit
  51.       PNG:  1-48 Bit - incl. interlaced
  52.     Targa:  supports all known RGB, RGBA types incl. compression
  53.      TIFF:  1-64 Bit, RGB, RGBA, CMYK, YCbCr with None, PackBits,
  54.             RLE, JPEG, G3, G4 and Next compression, Strips
  55.             or Tiles, Packed or separate color
  56.             (LZW not shipped with all versions of the IRW library)
  57.  
  58. As  you  can see, it does support several additional image formats
  59. and  does  replace  some  filters  shipped with PageStream.  Don't
  60. worry   about  compatibility.   You  can  still  use  the  limited
  61. PageStream filters if wanted.
  62.  
  63.  
  64.                          Installation
  65.                          ------------
  66.  
  67. Simple... run in the install program from the Workbench and it
  68. will do the trick. Next time you load an image in PageStream, you
  69. might get the "Studio's Universal Filter" offered when loading
  70. images. Choose it to make use of it.
  71.  
  72.  
  73.                        New since V1.xx
  74.                        ---------------
  75.  
  76. The Universal filter V2 is now using the IRW library to load
  77. images.  The IRW library is one of the basic components under
  78. development for color management applications.  The IRW library
  79. allows reading basicly any type of color data (palette, images...)
  80. in basicly any color space.  The library is also designed to
  81. handle all the extras that can be found in an image, including
  82. future additions.
  83.  
  84. What are the benefits of the new Universal filter thanks to the
  85. use of IRW:
  86.  
  87. - Now image data can be loaded with less than 8 Bit.  So <8Bit
  88. data is not converted to 8 or 24 Bit anymore.  This makes loading
  89. faster and requires less memory. 
  90.  
  91. - The IRW library does support many new data types:  CMYK, 16 Bit
  92. and such.  Note that PageStream currently does not handle things
  93. like 16 Bit, ICC or IPTC support as offered by the IRW library.
  94. The filter automaticly converts data whenever possible.
  95.  
  96. - New image formats are supported.  However, IFF DEEP support is
  97. currently removed until the old IFF code is rewritten and added to
  98. IRW.  Similar, I haven't found the time to add 24 Bit OS 3.5/3.9
  99. Datatype support yet. Keep using the V1 filter in case you must
  100. load IFF DEEP.
  101.  
  102. - PageStream does load all filters into memory during startup.
  103. Thanks to the image routines now being part of the external IRW
  104. library, the new universal filter requires nearly no memory unless
  105. an image is loaded.
  106.  
  107. - The IRW library does allow reading a complete image into memory
  108. without require a prescan of the image like the old routines.
  109. This can dramaticly lower loading times.
  110.  
  111. - The IRW library requires much less memory during loading of an
  112. image.
  113.  
  114. - The Universal filter is now free to any PageStream user.
  115.  
  116. - Reliability is a major concern.  Roughly 30 percent of the work
  117. involved was dedicated to error handling.  IRW does detailed error
  118. messages  including hints how to solve problems if available.  The
  119. error  messages are localized and often offer a Retry option where
  120. possible.
  121.  
  122. - All format specific details are handled by the IRW library.
  123. This allows adding new features and settings to the IRW library
  124. without requiring the Universal filter to be changed or updated.
  125.  
  126.  
  127. IRW is still under development.  Some major features are not yet
  128. implented.  To tell you some details not yet implemented but
  129. already planned or already partly done (in order of priority):
  130.  
  131.  
  132.                          Tech Info
  133.                          ---------
  134.  
  135.  
  136. Some more info about the Universal loader:
  137.  
  138. - Why this filter?  Simply because it didn't cost me much work and
  139. I  made  it  free  to  CanonStudio  and Studio owners in hope that
  140. someone  finaly  finds the time to forward images to me that don't
  141. get  loaded  by  the  Universal  loader.   So it's a way I hope to
  142. advance my image reading routines and make them work on nearly all
  143. images.   You  already  will  find  that it really works with MANY
  144. images where similar other software on the Amiga fails.
  145.  
  146. So,  please, if you do have problems loading an image, let me know
  147. of  it  and  just  don't switch to a different format to work with
  148. PageStream.   I  want the Universal loader to work with all images
  149. with formats supported.
  150.  
  151. - PageStream currently does only use the filter when importing the
  152. image.   Once  loaded,  it  the image is saved with the PageStream
  153. document  file without further need for the filter unless you left
  154. the  image  external in PageStream.  In this case, the filter will
  155. be  used  when  loading the images in the document again.  In case
  156. the  filter  is  not  available,  PageStream currently automaticly
  157. prompts the filerequester with the file to be loaded again using a
  158. different  filter.   So,  basicly,  it's safe to use the universal
  159. filter.   I  will  keep  it  updated in case Softlogik changes the
  160. filter interface.  And in case you run into trouble in the future,
  161. you shouldn't have any problems switching to a different filter.
  162.  
  163. So  using  the  Universal  filter  is  save for the future of your
  164. documents.   If  you  want to share document files with PageStream
  165. users without the Universal filter, simply make sure the images in
  166. your  document.   Or  better:   ask  the user to get the Universal
  167. loader ;-)
  168.  
  169. - Memory requirement. I know some PageStream users are running out
  170. of memory. So here is some info that might be usefull. PageStream
  171. does load all graphics filters during it's start. This means, a
  172. XYZ format filter does require memory on your machine even if you
  173. never will use the XYZ format.
  174.  
  175. So  if  you  are  low  on  memory,  you might think about removing
  176. filters from the PageStream3:Softlogik/filters drawer to a backup
  177. drawer on your harddisk.  This way you might gain lot's of
  178. precious memory.  Sure, buying more memory should be the first
  179. choice.  But there is more:  the Universal filter is extremly
  180. small requiring only little memory.  Only while loading an image
  181. the Universal filter will load the IRW library wich contains all
  182. the routines for loading images. 
  183.  
  184.  
  185.  
  186.  
  187.                          Known Bugs??
  188.                          ------------
  189.  
  190. CMYK  images  saved  in  JPEG  format  using  PhotoShop  are saved
  191. inverted.   This  is  a known fault of PhotoShop.  The IRW library
  192. tries  to  detect  if  the  images was saved by PhotoShop and does
  193. automaticly  correct the image.  In practice, this detection seems
  194. to  work  reliable  and  there are no known problems.  However, if
  195. your CMYK JPEG images do load inverted, than it might be caused by
  196. the detection being fooled.  Please report such images.
  197.  
  198.  
  199. If  you  do have an image in a supported format that is not loaded
  200. by the Universal filter, please report to:
  201.  
  202.          Wolf Faust
  203.          Am Dorfgarten 10
  204.          60435 Frankfurt
  205.          Germany
  206.  
  207.  EMail:  wfaust@uni.coloraid.de
  208.          (wfaust@wfaust.de in case wfaust@uni.coloraid.de fails)
  209.   http:  www.uni.coloraid.de
  210.    Tel:  ++49-69-5486556
  211. Mobile:  ++49-179-6924769
  212.    Fax:  ++49-69-95409598     (NO REPLY IS GIVEN VIA FAX!)
  213.  
  214. Please note in your report:
  215.  
  216. 1. What application was used to write the image you have trouble
  217.    with? What type of image is it (size, colors,...) ?
  218.  
  219. 2. What PageStream and Universal Filter version are you using?
  220.  
  221. 3. If possible, enclose a sample image (DO NOT SEND IMAGES AS
  222.    EMAIL WITHOUT GETTING ASKED FROM ME)
  223.  
  224. 4. How do you exactly load the image in PageStream?
  225.    Via Menu? Via ARexx???
  226.  
  227.                       COPYRIGHT/DISCLAIMER
  228.                       ====================
  229.  
  230. Copyright  ©1997-2001  Wolf  Faust.   All  rights  reserved.   All
  231. distribution-  and  marketing rights to the software are vested in
  232. Wolf  Faust.   The software and documentation has been provided to
  233. you  strictly  'as is', without warranty of any kind.  In no event
  234. shall  Mr.   Faust  be held liable for any loss or damages arising
  235. out  of  any  action,  from whatever source, concerning the use or
  236. inability  to use the product.  You may not use, copy, or transfer
  237. the  product,  or  any  copy  or portion, without prior consent in
  238. writing from or Wolf Faust.
  239.  
  240. Installer  and  Installer project icon (c) Copyright 1995-96 Escom
  241. AG.   All  Rights  Reserved.   Reproduced  and  distributed  under
  242. license   from   Escom   AG.   More  is  Copyright  (c)  1986-1993
  243. Commodore-Amiga,   Inc.   All  Rights  Reserved.   Reproduced  and
  244. distributed    under    license   from   Commodore.    Teile   der
  245. JPEG-Laderoutine basiert auf Arbeit der Independent JPEG Group.
  246.  
  247. INSTALLER  SOFTWARE  IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO
  248. WARRANTIES  ARE  MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY
  249. OR  RESPONSIBILITY  IS  ASSUMED.   THE  MORE  PROGRAM  IS PROVIDED
  250. "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE.  ALL USE IS
  251. AT YOUR OWN RISK.  NO LIABILITY OR RESPONSIBILITY IS ASSUMED.
  252.  
  253.  
  254.  
  255.                           THANKS
  256.                           ------
  257.  
  258.  
  259. At last a big thanks to the people (Deron, Gary...) at SoftLogik
  260. providing info, software and help to make this filter possible.
  261.  
  262.  
  263.                          History
  264.                          -------
  265.  
  266.  
  267. 16.09.97 V1.1 - First public version based on Studio V2.15
  268.         for test purpose.
  269. 18.09.97 V1.2 - BME's filerequester tried to loadcheck drawers
  270.         causing an error requester by Universal as no
  271.         drawer can be read...
  272.           - If loading a picture object with Datatype
  273.         fails, no error requester is displayed
  274.           - An error requester is displayed if the
  275.         SL_SystemInit() call to SL code fails
  276.         (bad PageStream version?) during the
  277.         start of PageStream.
  278. 24.09.97 V1.3  - Non-Standard IFF ILBM B/W 1 Bit without colormap
  279.          files saved by BME/PageStream are now loaded.
  280. 02.11.98 V1.31 - Now also checks/installs for PageStream V4 assign
  281. 02.02.99 V1.4  - DPI Information is now fowarded for PNG/IFF DEEP.
  282. 17.04.99 V1.5  - AsyncIO library caused crashes with interlaced
  283.                  GIF. Removed AsyncIO until author fixed that library.
  284.                - GIF now does much less Seek() calls.
  285. 01.05.99 V1.6  - Minor Bug:  Fixed problems with IFF images that
  286.                  are roughly >30% larger than uncompressed causing
  287.                  the IFF loader to prompt an error 48 because of
  288.                  buffer underrun.
  289.                  (So far, the only program I know that seems to save
  290.                  such ugly files: Candy Factory Pro).
  291. 03.09.99 V1.7  - Fixed a bug with TIFF RGB files with more than
  292.                  1 additional alpha channel (saved by PhotoShop
  293.                  for instance).
  294.                - Added support for TIFF LogLuv compression codec.
  295.                - Added support for images saved by Hemera products
  296.                  (NetGraphics and ClipArt CDROMs).
  297. 16.06.00 V1.8  - No more requesters are prompted for unsupported CMYK
  298.                  (and other) files.
  299.                - Fixed reading PCX files with 8 Bits per pixel with
  300.                  more than 1 plane.
  301.                - Reading of DCX files did not work. Fixed.
  302.                - BMP 4 Bit RLE compression did not work correctly
  303.                  and caused error requester. Fixed.
  304.                - Reading of PNG grayscale with alpha channel files
  305.                  did not work. Fixed.
  306.                - BMP 32 Bit support added.
  307.                - PPM/PGM P5/P6 comments and white space values
  308.                  are skipped while reading header.
  309.                - assert() debug calls disabled in TIFF source.
  310.                - Unknown TIFF compression schemes may be prompted
  311.                  to the user. The TIFF routines may continue
  312.                  loading faulty data despite the error message
  313.                  (bug in TIFF library). Fixed.
  314.                - Installer: uninstall added and update
  315.                  routines improved.
  316. 16.03.01 V2.00 - New filter now based on IRW library:
  317.                  - IFF DEEP support temporarly removed
  318.                    (keep using old V1.xx filter)
  319.                  + Now <8Bit data modes supported
  320.                  + much faster
  321.                  + nearly no memory used while not loading
  322.                  + support for 16 Bit and CMYK data added
  323.                  + enhanced PGM/PBM/PPM/JPEG/BMP/TIFF routines
  324.                  + improved error handling thanks to IRW
  325.                  + Locale Support
  326.                  + Compiled for various CPU for maximum speed.
  327.                  + lot's of small enhancements
  328. 04.07.01 V2.10 - Size of color palette was reported wrongly to
  329.                  PageStream. Color images with palette thus
  330.                  could cause crashes of PGS after loading such
  331.                  images.
  332.                  Thanks goes to DJNick <djnick@ptt.yu> for
  333.                  reporting the bug...
  334.  
  335.                - IRW Library Update to V1.05 (04.07.01):
  336.                  + Changed: Stack usage of tiff, targa and DoOpen
  337.                    routine lowered by roughly 1 KByte. This should
  338.                    better avoid crashes/faults with application
  339.                    calling IRW without enough stack memory 
  340.                    (PageStream/HHV!).
  341.                    PGS users: please increase stack size by roughly
  342.                    4096 bytes in order to get a decent sized stack!
  343.                    Thanks goes to Steve Bowman <stevebow@hotkey.net.au>
  344.                    for reporting the problem (wich was not a fault
  345.                    of the filter/IRW).
  346.                  + Changed: pnglib updated from 1.0.8 to 1.0.9
  347.                  + Fixed:   Failure accessing BMP header may not
  348.                    got prompted (failure code and error
  349.                    text was returned to application,
  350.                    but there was no error message shown
  351.                    by IRW to the user if the application
  352.                    asked IRW to do so).
  353.  
  354.  
  355.  
  356. (Continue by pressing 'Q')
  357.